List Tickets ByKey

When a business user adds a new biller, an L2 user of Business must approve the mapping before it is finalized.
This API fetches a list of pending approval requests for billers.

Endpoint

Method: POST
URL: {{URL}}/PL/jsonrpc

Headers

Key	Type	Required	Description
Content-Type	string	Yes	application/json
Product	string	Yes	PL

---

Request

{
    "method": "TicketService.ListTicketsByKey",
    "id": "1",
    "params": {
        "api": {
            "credential": "Basic bS5rdW1hcisxQG5ldHhkLmNvbToyYjVlMDIzMDg1NjU0YTE3ODUwZWE0N2Q1NWFlNWViNA==",
            "signature": "MEUCIQDW8WZP3E2wKyXZZVydkVO5c9iotcEDwU9PIPYbHYv+OgIgSdYUqJYqJi4TDtAl1Bx+MebtCDM0Ou/IGEnzPDUfnfg=", 
            "keyId": "231008"
        },
        "payload": {
            "applicationCode": "PL",
            "ticketName": "ADD_BILLER_APPROVAL",
            "state": "OPEN",
            "_skipUser": "m.kumar+1@netxd.com",
            "key": "528001"
        }
    }
}

Response: 200

Request Parameters

Parameter	Description
method Mandatory	String API method name Constant: TicketService.ListTicketsByKey
id Mandatory	String Unique request identifier
applicationCode Mandatory	String Application code Constant: PL
ticketName Mandatory	String Ticket name Constant: ADD_BILLER_APPROVAL
state Optional	String Ticket state Default: OPEN
key Mandatory	String Ticket key
credential Mandatory	String API credential for authentication
signature Mandatory	String Signature for request validation
keyId Mandatory	String Key ID for authentication

{
    "id": "1",
    "result": {
        "tickets": [
            {
                "id": "559001",
                "requestID": "142dfdb09c7e48bb8443052d97d0b37d",
                "applicationCode": "PL",
                "ticketName": "ADD_BILLER_APPROVAL",
                "createdTS": "2025-03-14T12:21:42.035Z",
                "updatedTS": "2025-03-14T12:21:42.035Z",
                "createdBy": "m.kumar+1@netxd.com",
                "payloadJSON": {
                    "accountID": "528001",
                    "accountNumber": "200213493088644",
                    "biller": [
                        {
                            "address": {
                                "addressLine1": "435 LAWRENCE BELL DR",
                                "city": "Buffalo",
                                "country": "USA",
                                "state": "NY",
                                "type": "Standard",
                                "zipCode": "14221-8440"
                            },
                            "billerClass": "Security Systems / Monitoring Services",
                            "billerId": "2786500317",
                            "billerName": "AMHERST ALARM",
                            "billerType": "Core",
                            "consumerAccountNumber": "374322123456789",
                            "createdBy": "m.kumar+1@netxd.com",
                            "createdDate": "2025-03-14T17:51:42.034729727+05:30",
                            "mask": {
                                "maskFormat": "@@@@@@@@@@@@@@@",
                                "maskLength": "15",
                                "maskRejex": "[0-9A-Z]{15}"
                            },
                            "status": "WAITING_FOR_APPROVAL",
                            "updatedDate": "2025-03-14T17:51:42.03472978+05:30"
                        }
                    ],
                    "createdDate": "0001-01-01T00:00:00Z",
                    "customerAccountType": "SAVINGS",
                    "sender": "General Account",
                    "updatedDate": "0001-01-01T00:00:00Z"
                },
                "state": "OPEN",
                "status": "WAITING_FOR_APPROVAL",
                "noOfApproval": 1,
                "ticketHistory": [
                    {
                        "updatedBy": "m.kumar+1@netxd.com",
                        "updatedDate": "2025-03-14T12:21:42.036Z",
                        "state": "OPEN"
                    }
                ],
                "key": "528001"
            }
        ]
    },
    "jsonrpc": "2.0"
}